Skip to content

[codex] Polish briefprint skill docs#18

Merged
dd3ok merged 2 commits into
mainfrom
codex/briefprint-polish-docs
Jul 5, 2026
Merged

[codex] Polish briefprint skill docs#18
dd3ok merged 2 commits into
mainfrom
codex/briefprint-polish-docs

Conversation

@dd3ok

@dd3ok dd3ok commented Jul 5, 2026

Copy link
Copy Markdown
Owner

Summary

  • Defer the README benchmark move because the root README and incident lifecycle example use different benchmark fixtures and the current README length is not a clear correctness problem.
  • Compact community install guidance for Gemini CLI, Antigravity, OpenClaw, and Hermes into an invariant-first table that warns about host syntax drift and points readers back to source links.
  • Shorten the skills/briefprint/SKILL.md frontmatter description while preserving supported input classes and excluded-use boundaries.
  • Add focused tests for compact install-doc structure and skill description routing terms.

Review Notes

Subagent analysis split the review items as:

  • 6.1 README length: defer.
  • 6.2 install docs vendor commands: implement surgically.
  • 6.3 shorter SKILL.md description: implement.

Final review:

  • code-reviewer re-review: APPROVE, no findings.
  • architect re-review: CLEAR.

Validation

  • python -m pytest tests\test_installable_skill_bundle.py tests\test_skill_metadata.py -q -> 9 passed
  • python -m pytest -q -p no:cacheprovider -> 164 passed, 2 skipped
  • python scripts\validate_skill.py --run-evals -> OK: briefprint skill repository validated (24 test files, 9 eval cases, 9 trigger cases, 4 model benchmark cases)
  • ruff check . -> All checks passed!
  • git diff --check -> no whitespace errors; Git emitted only CRLF working-copy warnings

Scope Notes

Local workflow artifacts (.agent/, .superpowers/, and docs/superpowers/plans/2026-07-04-briefprint-consistency-cleanup-plan.md) remain untracked locally and are intentionally excluded from this PR.

@dd3ok
dd3ok marked this pull request as ready for review July 5, 2026 05:42
@dd3ok
dd3ok merged commit 6b6be36 into main Jul 5, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant